home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / STUTTGART / FROMUTS / SAMPCONVERTER / !SampConv / !Help < prev    next >
Text File  |  1991-06-20  |  6KB  |  194 lines
  1. Help file for !SampConv
  2.  
  3. This application and code are public domain and
  4. © M. Farrow.
  5.  
  6.  !SampConv is intended to allow the easy conversion
  7. between a large variety of sound sample formats in
  8. current use on the archimedes.
  9.  
  10.  To convert a sample, drag it from the filer window
  11. (or another application) onto the !SampConv icon or
  12. the status window, and it will be loaded, and its
  13. format automatically detected.
  14.  
  15.  Once a sample has been loaded in, it will remain
  16. in memory, taking up application space, until the
  17. 'clear' option is selected from the main menu. This
  18. is to allow for multiple saves without the need to
  19. load in the source sample repeatedly.
  20.  
  21.  If the 'multitask' option is selected, the status
  22. window will pop up whenever a save is initiated, 
  23. (it can also be brought up by clicking on the
  24. !SampConv icon on the iconbar), and the sample will
  25. be saved in the background. If multitasking is not
  26. selected, the hourglass icon will pop up and the
  27. module will save at a slightly faster rate as a
  28. consequence of not being interrupted. The sample
  29. will either be saved in a series of 32 blocks, or
  30. blocks of 512 bytes (whichever is larger).
  31.  
  32.  Whenever a file transfer of some kind is in
  33. progress, the iconbar sprite will temporarily change
  34. to indicate the fact.
  35.  
  36.  Different sample formats contain variable amounts
  37. of extra information:
  38.  
  39.   Armadeus             : replay rate only
  40.   DSEdit               : none!
  41.   Tracker (headered)   : sample name, volume, loop-
  42.                          ing points (accurate to 1
  43.                          byte).
  44.   Tracker (unheadered) : none!
  45.   Soundsynth           : sample name, gate on/off
  46.                          volume tables, looping
  47.                          points (accurate to 256
  48.                          bytes).
  49.   Relocatable modules  : same as normal sample type
  50.  
  51.  The name and frequency (in KHz) of the sample can
  52. be changed from the 'alter sample' submenu. These
  53. do not affect the sample data itself, but are saved
  54. when the format has provision for either. If you do
  55. change the sample name/frequency and save in a
  56. format such as tracker (unheadered), the information
  57. will not actually be saved, so it is worth knowing
  58. more about the sample format you intend to save to
  59. before trying to rename all the samples (for
  60. example).
  61.  
  62.  Most Atari ST samples are in a linear unsigned
  63. format, and to convert one, it must be settyped to
  64. &FFD (data), and the whole file will be converted
  65. (header and all if there is one). The format is
  66. identical to the DSEdit sample format (ie. linear
  67. unsigned, no header), and there is no need to use
  68. !SampConv to convert between them (just change the
  69. filetype).
  70.  
  71.  There is a problem when converting headered tracker
  72. files to soundsynth format, because both formats
  73. use a different implementation of looping points.
  74. The program approximates the byte-accurate looping
  75. points from tracker to the 256-byte-accurate system
  76. used by soundsynth, and so the sample may not loop
  77. as well as previously.
  78.  
  79.  
  80.  If you experience any problems while using this
  81. piece of software, or have any comments you wish to
  82. make, feel free to get in touch with me by any of
  83. the contacts listed at the end of this text file.
  84.  
  85.  
  86. Important note
  87. --------------
  88. This application can only be distributed for free
  89. (with the exception of a small charge for disc and
  90. handling etc.), and can only be further distributed
  91. with all the files present and unchanged. Copying
  92. this application for commercial use, or duplicating
  93. parts of the code is not permitted unless permission
  94. is obtained from me beforehand.
  95.  If you are going to distribute this application on
  96. a large scale, I would still like to be informed so
  97. I can keep a record of what has been distributed
  98. where (in case I make any major updates/find major
  99. bugs [!])
  100.  
  101.  
  102.  
  103. Previous versions
  104. -----------------
  105. 1.00   Original version (name !STConv)
  106.  
  107. 1.01   Templates and small points improved.
  108.  
  109. 1.02   Now does app - app data transfer.
  110.  
  111. 1.03   Menu updated when saving different sample 
  112.        types.
  113.  
  114. 1.04   Raw samples now saved with type CB5 (tracker
  115.        sample type)
  116.        Fixed bug where info entry on menu opens up
  117.        save dialogue box (!)
  118.        New icon drawn to incorporate new tracker
  119.        samples icon.
  120.  
  121. 2.00   Name changed from !STConv to !SampConv
  122.        Completely rewritten (like !GetSTMod etc.)
  123.        Recognizes a lot more formats now:
  124.           Armadeus
  125.           Tracker (with/without SAMP chunk header)
  126.           DSEdit [new]
  127.           Soundsynth  [new]
  128.           Raw linear unsigned samples [new]
  129.           Relocatable modules (generated by Armadeus
  130.              application) [new]
  131.        Possible to save in many different formats:
  132.           Armadeus
  133.           Tracker (with/without SAMP chunk header)
  134.           DSEdit  [new]
  135.           Soundsynth   [new]
  136.           Raw linear unsigned  [new]
  137.        Multi-tasks (optional)
  138.        Uses new interface (naff way of doing it!)
  139.  
  140. 2.01   Fixed small bug in Tracker headered format -
  141.           when new headered samples were included in
  142.           Tracker tunes, !S/Tracker and !GetSTMod
  143.           didn't work correctly with them.
  144.        Fixed bug where some armadeus voice modules
  145.           were not recognized as such
  146.        New module formats recognized:
  147.           Shibumi-sound (from arcpinball)
  148.           4th dimension samples (1 2 and 3) -
  149.                [written by D.A.Fell/S.J.Middleton/
  150.                 anonymous]
  151.           Superior software format (?) (from super-
  152.           ior golf)
  153.           Armadeus (later version than the one I've
  154.           got!!)
  155.        Fixed bug where pressing certain keys in save
  156.           window initiated save. OK button now pops
  157.           back again!
  158.        Fixed small problem where you could save
  159.           tracker/soundsynth samples which were
  160.           larger than the format allowed.
  161.           
  162. 2.02   * This version *
  163.        Added option to save sample as a relocatable
  164.           module (module code © M. Farrow).
  165.        New RM format also recognised and loaded.
  166.        Buttons on status window changed (improved
  167.           method of handling them, and they pop in
  168.           as well!)
  169.  
  170.    
  171. You can contact me on:-
  172.  Arcade BBS [081-654 2212] (as Matthew Farrow)
  173.  Prestel (mbx 816706758)
  174.  Post: 45 Alleyn Park,
  175.        Dulwich,
  176.        London, SE21 8AT
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193. If this text has just scrolled by unreadably, try
  194. loading up !Edit first.